home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
551-575
/
disk_575
/
pplib
/
readme
< prev
next >
Wrap
Text File
|
1992-05-06
|
5KB
|
129 lines
**********************************
powerpacker.library V35.256
Release 1.3b
(c) 1991 Nico François
**********************************
First of all read the DISTRIBUTION file for information on... er well...
distribution :-)
Several people suggested the development of a library to help programs
decrunch files crunched with PowerPacker, and that is exactly what this is.
This library tries to make it very easy to support PowerPacked files. It
is a standard Amiga shared, runtime library and is called exactly like all
the other Amiga libraries. Using this library it will be a lot simpler to make
your program 'PowerPacker compatible' than with the previously distributed
decrunch source.
To install powerpacker.library copy it to your LIBS: directory by hand,
or run the installation script 'Install' (by using 'Execute' or by double-
clicking its icon).
You should also install reqtools.library in LIBS:. It is needed for
the requester functions in powerpacker.library. The installation script
will automatically install reqtools.library.
Using powerpacker.library
-------------------------
If you are a C programmer all you need to do is include the correct
headers and open powerpacker.library. After that you can use the functions in
the library as if they were C functions. If your program quits it must of
course close the library again. See 'example.c' for a very simple example.
If you are using SAS/C 5.10 and you don't want to use pragmas, or if
you are using version 4.0 or lower, you must link with LIB:pp.lib (small code)
or LIB:ppnb.lib (large code).
Programmers that use Manx C can use 'Bind' to generate the glue routines
they need (or if they are using 5.0 they can of course use pragmas for in-line
library calls).
Assembly programmers should also include the correct files and open
powerpacker.library. To call a function they must load A6 with the library
base, put the arguments in the appropriate registers and jump to the library
vector offset of the function they want to call. See 'example.asm' for a very
simple example.
All library functions are explained in the file 'pplib.doc'.
Enjoy.
LIBRARY HISTORY:
*****************************************************************************
RELEASE 1.0 (Library Version 33.1)
First release.
*****************************************************************************
RELEASE 1.1 (Library Version 34.1)
Added 'ppOverlayDecrHdr' for use of library from overlay decrunch header.
Requesters now have depth and close gadgets.
Faster decrunching in 'pp...DecrHdr' code.
*****************************************************************************
RELEASE 1.1a (Library Version 34.2)
Bug fixed: A6 was not preserved in ppLoadData!
Oberon interface to the library included.
*****************************************************************************
RELEASE 1.2 (Library Version 35.254)
PowerPacker 4.0's library decrunch header needs this version to work.
Some things have changed to crunch files even better :-)
After relocation of loaded executable the instruction and data caches
are cleared. This should insure compatibility with the 68040.
Note that this only applies to Amigas running Kickstart 2.0 (V37).
Crunching code added to library (4 new functions):
ppAllocCrunchInfo, ppFreeCrunchInfo, ppCrunchBuffer, ppWriteDataHeader.
One new requester function: ppEnterPassword.
The requester functions ppGetString and ppGetLong are now declared
obsolete! They can now be found (much improved) in 'reqtools.library'.
'reqtools.library' _MUST_ be installed in your system for the the old
(obsolete) requester functions to work! ppGetPassword and
ppEnterPassword also call functions in 'reqtools.library'.
ppErrorMessage function added to get default error messages.
Support for crunched LoadSeg files added for use with PPLoadSeg 1.1.
Stricter check for unknown data headers.
*****************************************************************************
RELEASE 1.3 (Library Version 35.255)
Fixed serious bug: PPLoadSeg files were incorrectly decrunched!
Now distributed with release 1.0a of reqtools.library.
Improved installation script.
*****************************************************************************
RELEASE 1.3a (Library Version 35.256)
Fixed serious bug: in low memory situations ppAllocCrunchInfo crashed!!
Small changes and enhancements to autodocs.
*****************************************************************************
RELEASE 1.3b (Library Version 35.256)
Updated Oberon interface by Kai Bolay included.
Release 1.0b of reqtools.library included.
*****************************************************************************
powerpacker.library written by Nico François (Yes, Nico is my first name :-)
thanks to Moroder Andreas for the useful suggestions.
Kai Bolay for writing the Oberon interface.
(c) 1991 Nico François / PowerPeak
//
Thanks to \X/ Amiga for being the best computer ever !